Skip to content

Comments

docs(ci): add documentation explaining CI workflow structure#485

Closed
tomsebastian10 wants to merge 3 commits intourunc-dev:mainfrom
tomsebastian10:main
Closed

docs(ci): add documentation explaining CI workflow structure#485
tomsebastian10 wants to merge 3 commits intourunc-dev:mainfrom
tomsebastian10:main

Conversation

@tomsebastian10
Copy link

Summary

This PR improves the documentation and clarity of the main CI reusable workflow (ci.yml).

It adds:

  • A high-level explanation of the CI pipeline
  • Inline comments describing each job
  • Clearer understanding of the workflow structure for contributors

Motivation

The CI workflow is a central part of the urunc development process, but new contributors may find it difficult to understand how the different jobs (linting, build, unit tests, E2E tests, Kubernetes tests) are connected.

Improving inline documentation makes the CI pipeline easier to understand and helps contributors quickly identify:

  • What each job does
  • When jobs are executed
  • How jobs depend on one another

This change does not modify CI behavior — it only improves readability and maintainability.

Changes

  • Added top-level documentation comment explaining the workflow
  • Added inline comments describing each job's purpose
  • Improved clarity without altering execution logic

Testing

No functional changes were introduced.
The workflow behavior remains unchanged.


Please let me know if any additional clarification would be helpful.

Added detailed comments to the CI workflow for clarity.
Added a section on Continuous Integration (CI) detailing the CI pipeline and its components.
@netlify
Copy link

netlify bot commented Feb 16, 2026

Deploy Preview for urunc ready!

Name Link
🔨 Latest commit 79a1ce0
🔍 Latest deploy log https://app.netlify.com/projects/urunc/deploys/69933f8a6963d8000810fa38
😎 Deploy Preview https://deploy-preview-485--urunc.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@cmainas
Copy link
Contributor

cmainas commented Feb 16, 2026

Hello @tomsebastian10 ,

thank you for your PR. While comments are always useful, I am not sure why the README should contain information about the CI. Also, please read and follow the contribution guide.

@tomsebastian10
Copy link
Author

Hello @tomsebastian10 ,

thank you for your PR. While comments are always useful, I am not sure why the README should contain information about the CI. Also, please read and follow the contribution guide.

Hi @cmainas,

Thank you for pointing that out.

I will remove the CI section from the README and instead place the documentation under the appropriate location in the /docs directory, following the contribution guide.

I will also open an issue first as required and reference it in the PR.

Thanks for the guidance!

Removed Continuous Integration section from README
@tomsebastian10 tomsebastian10 changed the title docs(ci): Improve CI workflow documentation and inline comments ddocs(ci): add documentation explaining CI workflow structure Fixes: #487 Feb 16, 2026
@tomsebastian10 tomsebastian10 changed the title ddocs(ci): add documentation explaining CI workflow structure Fixes: #487 docs(ci): add documentation explaining CI workflow structure Fixes: #487 Feb 16, 2026
@tomsebastian10 tomsebastian10 changed the title docs(ci): add documentation explaining CI workflow structure Fixes: #487 docs(ci): add documentation explaining CI workflow structure Feb 16, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants